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/^BSTRACT 

The, CADET Project Modilication computer analysis, and 
both hard copy map-likfe images ahd computer tapes are available to 
the public. A ma i nf rame computer program that permits an Apple 
microcomputer user to select a particular 40 by 40 pi^el sub-scene 
from a Landsat computer compatible tape and download it to Apple 
computer dislcette via telephone was developed at the University of 
Oklahoma. Beqause this mainframe program was designed to operate with 
United States format Landsat computer tapes, the program was modified 
to ruh with Cafiadian Landsat tapes*- In addition, since the U.S. ^ 
program operates on an IBM mainframe/ additiornal modification was 
necessary for the program to run /6n the University of AlbertaVs 
Amdahl mainframe. This report discusses the modifications made on 
both the maiq^frame and Apple programs and provides information to; 
operate the mainframe program psing Canadian Landsat tapes. This 
information includes: (1) the stepis. negessary to run the Landsat 
Digital Image Analysis Program; (2) an example of a complete run; and 
(3) a list An<3 purpose of files and routines written for the 1 
preprocessor package. (JN) ' • " 
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Landsat satellites continuously monitor the surface of the earth, sending 

digital data to receiving stations. Tlie data is modified for ooirputer ^lnaly8i6, 

and both hard copy map ifke images and computer tapes are available to the 

public. In Canada, the Prince Albert ' Satellite Station receives Land3at data 

eind provides it to the public. While analysis of the hard copy images can be 

undertaken witliout special equipment^ the computer tapes; <x)ntaining the '\ 

digital data do require special equipnent. State of the art equipment consists 

V 



of a mini-coniputer r and elaborate eoftv»re for extracting and analyzing the 
data^on a monitor. This is too expensive for the average classroom ^nd would 
ordinarily be found in government funded agencieSf specialized university 
departments r ^lnd private industry/ 

The capability of working with the ooft^xiter C50irpatible tapes unlocks the 
full power of Landsat data analysis. The digital data pixels, discrete points 
on the Landsat iirages, can be color coded according to their numerical value, 
and a resulting image can be created on the monitor. ThuSr a field o^ wheat 
that is stressed by drought, or insect infestatiwi, would Hiive a particular • 
pixel range. By assignii1t| that reuige a color on the computer , bj\6 calling up 

Vxi. ... • ^ 



1 



\ 

\ 

s ♦ 

the Ima^r all areas on that image having the same tJolor could be wheat under 
stress.. Animal habitats could also be determined in this imnnerr as well as 



certain types of pollation trajectories^ water conditions^ and man-made 

features. Ordinarily , a standard Landsat image contains an area 185 km X 185 km 

^ 5 

wlt±i about 7.5 X 10 pixels. . . * 

At the University of Oklahoma ^ Dr. John Harrington and his aBOOciates 
develojped a mainframe computer program thlfb permits an Apple microcomputer user 
to select a particular forty by forty pixel sub-scene from a Lant|iBat computer 
compatible tape and download it to Apple computer diskette via telephone. Ttie 

mainframe converts the binary data to text file for downloading^ and the 

< 

University of Oklahoma Apple program repacks thetteSt file into a binary file 
for 2inalysis. ^ Once in a binary file^ the prog'reun alloWs a user to assign colors 
to p^^^s in either low or high resolution colors for analysis purposes. In 
addition, there are several other analysis progreums that provide a histogram of 
the pixel values in each spectral bapd downloaded, and graph a two point 
scatter^ plot of two spectral bandSu. While noty a^ elaborate a^ the mini- 
computer operation, users of Apple computers are now able to undertake 
extraction and anaiysidf of Landsat data. 

There Xs a difference, though. In pixel shape between the profesBional 
systems that analyze Landsat computer data and the ^^le progri^, 1\\e former's 
pixel shape Is rectangular, narrow side up, and the latter 's is square. This 
tends to give a slightly squatter shape to the Apple C.R.T. image as oonpire^ 
with the other but does not affect euialysis. 

A major prdolem of tlie Oklahtoma mainframe program is that it is designed to 
operate with U.S. format Landsat cdrputer tapes. The majof: thrust of the work 

' ' ' A 

reported here was the iwDdification of the Uhiverslty of Oklahoma program to ruij^ 
with Radian Landsat tapes. An additional subsidiary element wa%. that the ^ 
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molnfrajne progriini is also designed for an I.B.M. n^ainf raipe, and modification 
*'*^ t * 
for it to run on the University of Alberta's Xmdahl mainframe was also 

necessary. 

Using funds provided by the Innovative Project Fund, a systems analyst was 
employed to undertake the mcxJificatlons.^ After much trial and error, the ' 
Htxllfications were successful. The help of the Alberta Remote Sensing Center 
was of much value, providing both expert advice for the tapes, and materials 
Including format manuals and a loan of a tape with which. to make modifications. 

* 

Dr. Harringto^j of the University of Oklahonw was also of help, sending a "sample 
tape ^^nd microfiche data. Sei^ral conference calls were made both with the" 
Remote Sensing Center and Dr. Harrington for the benefit of the systems- 
iuialyst, . ^ ^ . ~" 

^ With <the use of equipment provided by the Apple Canad^ Education 

Fbundatiop, thp mainframe program was tested, and the Apple programs modified. 

The mainframe program modification included an innovative procedure that 
by-passed the Apple program procedure. The original University of Oklahoma - 
program has a diskette prof ram that allows the user to sej;ect^the subscene to 
be downloaded. In the modification, the selection procedure is done via a 
program in the mainframe that is self-proirpting. The user is prompted for the 
center line and pixel number of the eubecene, then the length and width of the 
scene. Hiis data can then be saved as a pemanoit file or destroyed at the 
conclusion of the download euid. sign-off. Uiis procedure permits the creation 
of a file larger than forty by forty pixels from which sOb-scenes can be 
' downloaded by others without entering the coirputer tape. The user is then . " 

prompted for the forty by forty pixel subscene, to be downloaded from the new 
file, also by a request for tiie center line and pixel. Hie program then pscks 
binary to text, and the user downloads the text file, using Vislterm conmunications 
software. 

ERIC ^ • ,4 



user signe-off and repacks the text file to binary in the Apple. 
Bere is whfere another modification was made to the Oklahoma program. In the 
original program, if all 1600 pixele were not transraittedr the binary pocking 
program would abort. In the modified program,- the text file ie examiiied for 
its lenc/^, and if less than 1600 pixel lines are present, the new program adds 
sufficient lines of ieros to allow the lacking program to operate^ Thus, a 
text file that was partially downloaded because of ^m interruption can ine saved 
for analysis. ' ' 

Vtiile the mainframe and micro programs are now functional for Canadian 
Lfindsat computer compatible tapes some additional mcxJifications are suggested: 

1. The binary packing program-is in integer basic. It would be speeded up 
if it was converted to machine language. Presently it takes about an hour to 
download and pack a text file to binary. T^e pocking is about twenty-eight ^ 
minutes. It could be reduced to about twelve minutes. 

2. The procedure for counting pixels on the computer tape follows a 
standard procedure outlined by the Canada C^ter For Remote Sensing. However, 
the Alberta Renote Sensing Center uses a different program to count the pixels, 
and there is a discrepcuicy betv^n the two programs. If an optional program 
oonpatible with the Alberta Remote Seeing Center's program can be written for 
the mainframe it would allow Apple users to call upon the Center to determine 
pixel locations for center scene downloads. Presently, a user must rough, guess 

^ location and download through a trial and error procedure. 

Attached to'tHip report is the report of the systems analyst for operating 
the TOainfram^progrcu*. Cne addition has been made since the emalyst's report 
was received. ' Hie mainframe program has^ been modlfiefl to jrequest the mounting 
of a ppecific Lan5sat ccnrputer tape in ord^r tovallcJw multiple tape use. 
Previous to this, only one tape specially iilounted for the program could be 
utilised. ' ♦ ' 
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It is nry pleasure tx> ^tate that to the best of my knowledge and belief, 
this Ifi the first time that Canadian Landsat tapes have been used with the 
ttiiverslty of Oklahoma Program developed by Dr. John Harrington and his --^ 

associates, and that inprovements have been made that enhance the original 

\ 

program. . - . 
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lANOSAT OICITAl ANALYSIS P^ACKAGE: - OPERAT ING PROffOURr 

Below is a list of the steps necessary to run the Landsat 
Digital Image Analysis Package. ^ 

5TEP"l: ^ 

, tlP^ert the VI5I-TERM diskette into the disk drive and turn 
on the machine. 

STFP 2 : . 

Below is a list of the options that must be specified before 
the data can be down-loaded to the APPLC. 

a) Hit ESC-SHiri-l to get into options mode. 

b) Set the ^^llowing options: 

EOB CHAR $0A [J] , 
ACK CHAR . $3F ) 
AUTO ACK NONE 

c) Hit "F" to get into file transfer mode. Set the following 
options: 

■ . - .\ ^ 

FILENAME (this is thjdf destination of the down-loaded data) 
PROTOCOL 'FOB - ACK \ - 
' BLOCK CHRS DROP ^ ' , » 

'EOF CHAR $25 ?o 

d) Hit '*T" to get back into Terminal mode. The options are now 
in the correct format. 

Note: The filename used is the file into which the Landsat data wi 
be put. DOjWOT use ttje 'filename of an existing file uniess it is 
a text file and you don't need the contents any more. The contents 
in this file will be over written and will be lost. 

STEP 3 : 

You are now ready to start the Preprocessing atage of the 
digital image analysis ^package • At this point \you nave and option: 

a) You may extract- a new scene from the CCT (computer compahabie 
^ tape) and down*-load a sub-scene of this to the APPLE 

-OR-, , , . ' 

b) You may down-load *a sub^scene from a previously extracted 
and saved scene to the APPLE, 



Note: To select option "b" you must have previously extracted 
(option "9") and ,saved a scene off the data tape* You will be 
prompted for the name of the saved data so have it ready. 



STEP ^: • . • 

■ *■ 

It is now time to sign 'on to MTS (Michegan Terminal System). 
There are two numbers that will ponnect you to the system, they " 
are: 432^801 .and 432-4811. Onc^tou pre connected you will be 
greet«I^^MTS and will be asl<re^|jjj^|£nti fy the terminal that you 
ork^q 




are working on. The - following ^^^ppPlar on your screen 
#Enter terminal id 

Answer this question by typing in the letters "LA36" (don't include 
the quotes) and hitting return. Now type in the following: 

SIGNOKl CHAT ^ ' " |) 

Hit return. You will be prompted fx)r the pasword for "CHAT". 
Type in the password and hit return. You are now signed on. 

STEP 5: . ^ \ 

" 3 

Note: If you selected option "b" of st6p 3 then proceed to step 6.J 

In this step you will be extracting a scene (or picture) 
frgm the Landsat data tape. The scene is specified by the element 
number and scan line number of the pixel in the center of the scene 
and by the heighf^nd width of the scene (the number of pixels high 
by the number of pixels wide"). To start the extraction type in 
the command : ^ 

EXEC STEP1 

f 

After the tape is mounted you will be asked to en^er the 
scen^ center scan line number and ^element number. Enter these^|f 
two numbers and hit return. You will then be asked to enter the 
height and width of the scene. Enter these numbers and hit return. 
The last , prompt will be for the scene title* Type in the name 
of the ^cene here and hit return. The extraction of tfie desired 
scene will now be carried out. 

After the scene has been extracted you will be a^ked if you 
wish to save bhe extracj^ scene. ^ 

- If you answer *'N0" then the ^Jbi^ will be destroyed after 
the session is over. 

- If you answer ^"YES" you will be prottipted for a file name. 
Enter a name and hit return. The data will be saved and 
will be available the next time you sign on. 

No^: The data files are large and are costly to save - so they 
should not be saved unless several sub-scenes are to be downloaded 
from the same extracted scene. The data files may be destroyed - on 
created ^ by the oommand: 



$DELETE [filename] . ^ . 

where [filename] is the name of the file. This command should 
be given at the beginning of a session. 
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STEP 6: ^ 

In this step the extracted data willVl^e processed and then 
sent over to the APPLE text file. To begin this step type in the 
command: . ^* 

EXEC STEP2 

Ttie utility programs wilJ determine the range of* scan lines and 
elemen^ numbers in the extracted acene. This information will be 
printed on you scrfeen . You will then be asked to specify the 
center of the sub-scene to be downloaded to tRe APPLE, Enter the 
Qcan.line number and the element number of the pixel at the center 
of the 8ub~-scene you desire. Hit return. When the desired sub-scene 
r)as been, located the follow_^g will appear on your screen: 

Prepare fc>r data transfer... 
(nee nee nee... working...) 

At this time you have 60 seconds to get your APPLE ready to receive 
the data. This should be plenty of time so don't pdnic- Once the 
above message appears enter the following: ^ 

f. 

a) Type ESC-SHirT-l to get ^into options mode. 

b) Enter a "E" to get into file transfer mode. ^ . ^ 

c) Enter a "R" to start receiving the data. If the file \ 
already exist then enter a second^ "R" to cause the file 

to be replaced. 

d) After 60 seconds havei ^lapsed hit RETURN « ONCE. You should 
now see the d^t^ being transferred. 

N(^e : If the data transfer ^stops before 1600 lines have been 
sent then hit return again - the stoppages are usually cause(l by 
noise on the line a njt^ a return should get the data transfer 
going again. / 

When all 1600 lines have been transferred drop the line 
(hang up the phone). The MTS programs will sign yoti off auto- 
matically, T^e data transfer is now complete. ^ 

STEP 7: . ^ ' ■ ^ 
1 — 

Now that the data is in a tqxt'^file, it can be packed into 
binary data files. This/step is necessary to convert the format 
of the data into a form' usable to the Digital Processing Programs. 
To do this the followin^^ steps should be taken: 

a) In§ert the "Digital Triage Analysis System - Main Programs" 
disketta into the disk drive and turn the machine on. 

b) When the main menu is printed- on your screen choose selection 
^ number 2 (PACK DATA IN BINARY FILES). 

i^' ♦ - ■ 

c) When prompted for the "PD^EL EXTRACT FILE" naf4 give it the 
same file name that you entered in step 2c. 



f • 

^ Oice the data has been packed into binary files and sfe'ored 
on a diskette you will be ready J^o proceed to- the analysis programs, 



SAMPLE RUN OF PREPROCESSlNiG PACKAGE PROGRAMS ON MTS. ' ''^ . . 

In the following two pages, 8 sample output of one preprocessing 
run is shown. The underlined portions ate the response^ of the us^T. 
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LA ^DSAT DIGITAL ANALYSIS PACKAGE 
Below ie an example of a complete run 

— 1 ^ 



lEXEC STEPl 
^ LANDSAT DATA ANALYSIS PACKAGE 
University of Alberta 13:08:<f5 07-09-6^ 

r 

TKe data tape muSt be mounted - please wait.. 

.*T»: MOUNTED ON T3C5 

Enter scene center pixel scan Line 
number arid element number: 12Q4'1o5o 

fjnter the height and width, llTpixels, 
of the area to be extracted: 120 ^0 

T 

Enter the scene title : TEST , JULY 9, 19flA 
File "COMMANDS" has been -created . 

Execution begins... ' 

( / ■ _ - 

IMAGE DATE 26JUL82 

.SCENE ID ■ . 2236717533 

PIXEL BOUNDARY 1140 '979- 

PIXEL BOUNDARY '1260 979 

PIXEL BOUNDARY 1260 1021 

PIXEL BOUNDARY , 11A0 1021 

riLE TIJLE TEST, JULY 9, 1984 

' RUN BIP EXTRACT 

NOTE: THE UNTpIMEB EXTRACTED AREA IS 48X127 

NOTE: EXTRACJ^tiN COMPLETED 

NOTE: 4879 PIXELS EXTRACTED - • ■ 

NOTE: SWICHING I/O FILES-, JN=12, 0UT=10 

N0T£: END OF FILE - 

STOP 112 

. ' .11 



still executing ... ^ 

Oo you wish to^eave the extracted data? (yea/no) : NO 
*T*j T3C5 released 

bye . . . 

#EXEC ■STEP2 

# $5ET ECHO=:Orr 

LANDSAT PATA ANALYSIS PACKAGE 

University of Alberta 13*11 i38 07-09-8^ ^ 

Please w^it. . . " * 



.SCAN LINES RANGE FROM' 980 TO 1021 

ELEMENT NUMBERS RANG^ FROM 1141 TO 1260 

ENTER SCENE CENTER SCAN LINE AND ELEMENT NUMBER: 1000 



Prepare for data transfer.., 
(nee nee nee . . working . , . ) 
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SOFTWARE WRITTEN FOR JHE Pf^EPRQCESlSOR PACKAGE 

* 

Below is the list of files and routines written for the 
Preprocessor Pagkege: 4 ' . * 

ft * 

1) File Name: STZV^J (EXEC, file) 

Purpose: This fiJ)^, wher> EXECuled, causes sev^eral utility 
- ^ programs and the Preprocessor Program 'to be r\jn. 

^ ^The utility programs are* neceasary to set things 

up properly for the Preprocessor • 

2) File Name: * J&TEP2 ' (EXEG file) ; , 

Purpose: This file, when EXECuted, causes several utility 
programs to be run* The last program executed 
sends the data to the APPLE, The other routines 
put the data' in the correct format. 

3) File Name: READER (FORTRAN subroutine) 

Purpose: this routine is call by the 'Preprocessor Program 
to r^ad the data off thfe .Canadian format CCT*s. 



4) File Name: ^fllfvERT (FORTRAN program)^ 




Purpose: " ThiJWbutine is run in STEP2 and converts the 

data Lo be sent into, character stringV. This is>the 
last step before the/data is dowrfloaded^ 

5) File Name: SENDME- (FORTRAN program). 

Purpose: This routine sends the d^.ta to the APPLE in EQB-ACK 
protocol. 

6) File Name: RENAME (FORTRAN program) 

Purpose; This routine will create ^ permanent file in which 

the extracted data will be stored if the u§6r specif iei 
that the data is to be saved, 

7) File Name: CREATE . (FORTRAN program) 

Purpose: This routine builds the command file which instructs 
' the Preprocessor Program which pixels to extract* 

8) file 'Name: PICK (FORTRAN program) ^ 

Purpose: 'This routine scans the extract data for the scan line 
range and element number range • This information is 
used by routine- GATHER to assemble J:he desired sub-scei 
of the extracted data for downloading. , ' - 
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File Name:^ GATHER (FORTRAN program) 

Purpose; This routine gathers up the correct pixels from the 
extracted data apd puts them into a separate file,. 
• 9 This file will be converted into the correct format'* 
and will be downloaded. ' 
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MODIFICATIONS MADE TO EXISTING SOFTW/\RC 

■■"[ 

;^Beloy^is a llet-of the changes- made' to the exlstipg IFbTtware 
(this i« the ^et^f. programs on the APPLE diakette and tfte Processing 
Package program on the magnetic tape). - . . 

1) / Routine Narngj Digital Image Analysis Programs Package 

Fire: Programs are on the APPLE diskette,. 

Purpose: These programs ere ubed to procq^' the di^^tal data* 

^hangea: The catalog of programs was correooec so that the 
[ menu ^choices correspond to the p'ropek routines , ^ ^ 

Thie HELLO program was cVianged so that IrVteger Basic 
is loaded into the language card ea^h tirnVthe machine 
is booted up on this diskette.. Integer BaslvC is used 
bygone of ^ the routines and was not previouslyXpvailable 
on this d-iskette. 

Thje user now has the option to run Boomer Sooner oi 
^to omit it. If you wish to omit Boomer Sooner, just^ 
hit "RETURN^* when pr'omptea for a response to the Boomer 
Sooner question • 

2) Routine Name: Preprocessing Program. 
File! LS.MAINPR03 ». • 

Purpose: To extract scenes from Landsat data tapea. 

• ' ^ ' 

Changes : The EXTRCT routine was changed .sot that the preprocessor 
' would use Cana^iBn format Landsat tapes* EXTRCT now 
calls a routine "READER** which does the actual reading 
of data on the tape. Some output formats were plso 
changed in the EXTRCT routine. 

r The PRTMAP^ routine was modified so that a call to a 

system subroutine that is not available on MTS does 
not occur, ^ This routine was dialled to get the time 
and date and its' omission does not present any problems. 
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